Skip to content
This repository was archived by the owner on Oct 12, 2022. It is now read-only.
/ druntime Public archive

Conversation

@wilzbach
Copy link
Contributor

@wilzbach wilzbach commented Feb 8, 2018

From https://github.com/dlang/dlang.org/blob/master/dlang.org.ddoc#L353

The REF1 variants work around DDoc limitations and allow linking to
modules not inside packages (i.e. object.)

Argh...

See also: dlang/dlang.org#2191

@wilzbach wilzbach requested a review from andralex as a code owner February 8, 2018 09:55
@dlang-bot
Copy link
Contributor

Thanks for your pull request, @wilzbach!

Bugzilla references

Your PR doesn't reference any Bugzilla issue.

If your PR contains non-trivial changes, please reference a Bugzilla issue or create a manual changelog.

wilzbach added a commit to wilzbach/dlang.org that referenced this pull request Feb 8, 2018
REF1 is currently only used once in entire DRuntime and Phobos, so maybe
a special OBJECTREF macro would have been better?
Anyhow, have a look at the only use of `REF1` to understand the
motivation for this PR:

https://dlang.org/phobos/std_file.html#.thisExePath

Also there are three other PRs being blocked on this:

- dlang/dmd#7342
- dlang/druntime#2082
- dlang/phobos#6140
@wilzbach wilzbach added the Trivial typos, formatting, comments label Feb 8, 2018

Users should prefer $(REF destroy, object)` to explicitly finalize objects,
and only resort to $(REF __delete, core,memory) when $(REF destroy, object)
Users should prefer $(REF1 destroy, object)` to explicitly finalize objects,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There's a dangling backtick here.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed (as the changelog file has been removed now.)

@dlang-bot dlang-bot merged commit dff824e into dlang:master May 18, 2018
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

Trivial typos, formatting, comments

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants